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Section 1 


Introduction 
The HP-71 Development Utility is a program that runs on the HP-71 and allows you to transfer files 
between the HP-71 and another computer called the “host.” 


An HP-71 Development Utility work station is the equipment and software that allow you to transfer files 
between the HP-71 and a host. 


Using This Manual 


The purpose of this manual is to give general information about how to set up and use an HP-71 Develop- 
ment Utility work station. 


Section 2 explains how to set up an HP-71 Development Utility work station. 


Section 3 explains how to transfer files from a host to the HP-71 (download) and how to transfer files 
from the HP-71 to a host (upload). 


Section 4 explains how to customize the HP-71 program for a variety of hosts and interfaces. This section 
is not necessary for many work stations. 


Appendix A is a review of the sections and is meant to be used as a quick reference guide. 
Appendix B contains the listings of sample programs. 
Appendix C is a glossary of terms used in this manual. 


Appendix D is a list of error conditions, their causes, and possible solutions. 


Capabilities 


The HP-71 Development Utility work station is a file transfer system for the HP-71. It gives you the 
ability to transfer text files between the HP-71 and a host, thus allowing you to use the facilities of a 
desktop computer to develop files for the HP-71. 


Included in this packet is the HP-71 Development Utility, which runs on the HP-71. This program is a 
general solution, flexible enough to transfer files to and from “all” potential hosts. 
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Requirements 


A minimal HP-71 Development Utility work station consists of: 
e A host with HP-IL. 
e HP-IL cables. 
e An HP-71 with HP-IL. 


If the host does not have HP-IL, another interface with an interface converter can be used: 
e HP 82169A HP-IL/HP-IB Interface and HP-IB cable, or 
e HP 82164A HP-IL/RS-232-C Interface and RS-232 cable. 


To copy the HP-71 Development Utility program, it is useful to have: 
e An HP-71 card reader, or 
e An HP 82161A Digital Cassette Drive. 


Software is necessary on both the HP-71 and the host for the transfer process: 


e The HP-71 Development Utility runs on the HP-71. This program controls the HP-71 end of the file 
transfers. It is provided on a magnetic card (a cassette tape is available through the HP User’s Li- 
brary). An annotated listing of this program is in Appendix B: Sample Programs. 


e A program is needed on the host to upload the files. This program is very simple and is entered by the 
user. Sample upload programs are in Appendix B: Sample Programs. 


e File download also requires software on the host. The sample programs in Appendix B: Sample 
Programs also contain downloading routines. In many cases, however, you can download a file using 
the printing capabilities of the editor or operating system. 


References 


This manual does not discuss the general operation of the HP-71, any possible hosts, or any of the inter- 
faces or interface converters. Here is a short list of references on these topics: 


e HP-71: HP-71 Owner’s Manual. 
e Hosts: Host system documentation. 


e HP-IL: HP 82401A HP-IL Interface Owner’s Manual (HP-71), HP 82938A HP-IL Interface Owner’s 
Manual (Series 80), The HP-IL Interface Specification, and The HP-IL Integrated Circuit User’s 
Manual. 


e HP-IL converters: HP-IL/RS-232-C Interface Owner’s Manual, HP-IL/HP-IB Interface Owner’s 
Manual. 


Section 2 


Configuration 


This section covers the configuration of the HP-71 Development Utility work station with the HP-86/87 
or the IBM Personal Computer as a typical host. Also, some guidelines are given for setting up a work 
station with other hosts. 


HP-86/87 With HP-IL 


Required Equipment 
To set up an HP-71 Development Utility work station with the HP-86/87 as the host and HP-IL as the 
interface, the following equipment is needed: 

e An HP-86/87 with a disc drive. 

e An HP 82938A HP-IL interface. 

e HP-IL cables. 

e An HP-71 with HP-IL and a card reader or a cassette drive. 


Connecting the Work Station 


1. Power down: Turn off the HP-86/87, disc drive, the HP-71, and any other devices on HP-IL. 


2. Connect cables: Connect HP-IL cables to and from the HP-71, the HP-86/87, and any other devices 
on HP-IL. Make sure that the HP-IL cables form a complete, unbroken loop. 


Note: For use in the HP-86/87 program, note the device selector of the HP-IL interface (the default is 
9). Refer to the HP-86/87 Owner's Manual and Programming Guide for more on device selectors. 


3. Power up: Turn on the disc drive, the HP-86/87, the HP-71, and any other devices on HP-IL. 


The HP-71 Development Utility work station is now connected and ready to run the HP-71 Development 
Utility (refer to Section 3: Operation). 
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Testing the Work Station 


The following is a test to make sure that the HP-71 and HP-86/87 are communicating: 
1. Prepare the HP-71 to receive data from the HP-86/87: 
“ENTER DEVADOR SC "S13: AF 
2. Send a message from the HP-86/87 (assuming that the device selector of the HP-IL interface is 9): 
QUTPUT Si "Helle HF-*1l, how are uout" 


3. Check to make sure that A$ in the HP-71 has the message that you sent from the HP-86/87: 
SOITSP As 


HP-86/87 With HP-IB 


Required Equipment 
To set up an HP-71 Development Utility work station with the HP-86/87 as the host and HP-IB as the 
interface, the following equipment is needed: 

e An HP-86/87 with an HP-IB interface and a disc drive. 

e An HP-IB cable. 

e An HP 82169A HP-IL/HP-IB Interface. 

e HP-IL cables. 

e An HP-71 with HP-IL and a card reader or a cassette drive. 


Connecting the Work Station 
1. Power down: Turn off the HP-86/87 and disc drive, unplug the HP-IL/HP-IB Interface, turn off the 
HP-71 and any other devices on HP-IL. 
2. Set the mode switch on the HP 82169A to “mailbox” mode. 


3. Connect cables: Connect one end of the HP-IB interface cable to the HP-IL/HP-IB Interface; connect 
the other end to the HP-IB port in the HP-86/87. 


Note: For use in the HP-86/87 program, note the device selector of the HP-IL/HP-IB interface. Refer 
to the HP-86/87 Owner’s Manual and Programming Guide for more on device selectors. 


Connect HP-IL cables to and from the HP-71, the HP-IL/HP-IB Interface, and any other devices on 
HP-IL. Make sure that the HP-IL cables form a complete, unbroken loop. 


4. Power up: Turn on the HP-86/87 and disc drive, plug in the HP-IL/HP-IB Interface, turn on the HP- 


71 and cassette drive, and any other devices on HP-IL. 


The HP-71 Development Utility work station is now connected and ready to run the HP-71 Development 
Utility (refer to Section 3: Operation). 
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Testing the Work Station 


The following is a test to make sure that the HP-71 and HP-86/87 are communicating: 
1. Prepare the HP-71 to receive data from the HP-IL/HP-IB interface: 
Z2EMTER ODEVAOORG "Ser" 3: AF 
2. Send a message from the HP-86/87 (assuming that the device selector of the HP-IB interface is 705): 
MUTPUT PRS: "Hello HP-fl, Row are yout" 


3. Check to make sure that A$ in the HP-71 has the message that you sent from the HP-86/87: 
POTS aS 


IBM Personal Computer With RS-232 


Required Equipment 
To set up an HP-71 Development Utility work station with the IBM Personal Computer as the host and 
RS-232 to HP-IL as the interface, the following equipment is needed: 

e An IBM Personal Computer with an RS-232 interface (serial interface) and a disc drive. 

e An RS-232 cable. 

e An HP 82164A HP-IL/RS-232-C Interface. 

e HP-IL cables. 

e An HP-71 with HP-IL and a card reader or a cassette drive. 


Connecting the Work Station 


1. Power down: Turn off the IBM personal computer and disc drive, unplug the HP-IL/RS-232-C Inter- 
face, turn off the HP-71 and any other devices on HP-IL. 


2. Initialize the HP-IL/RS-232-C Interface: The standard configuration for this interface is DTE. To 
work with the HP-71 Development work station, the configuration needs to be DCE. This is done by 
switching the configuration selector. Refer to the HP 82164A HP-IL/RS-232-C Interface Owner’s 
Manual for information on how to switch the configuration selector. 


3. Connect cables: Connect one end of the RS-232 interface cable to the HP-IL/RS-232-C Interface, the 
other end to an RS-232 port of the IBM personal computer. 


Note: For use in the IBM program, note which RS-232 port the cable is connected to. COM1 is the 
female port; COM2 is the male port. Refer to the IBM Personal Computer documentation for more on 
the RS-232 ports. (On some systems the male port is COM1). 


Connect HP-IL cables to and from the HP-71, the HP-IL/RS-232-C Interface, and any other devices 
on HP-IL. Make sure that the HP-IL cables form a complete, unbroken loop. 
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4. Power up: Turn on the IBM Personal Computer and disc drive, plug in the HP-IL/RS-232-C Inter- 
face, turn on the HP-71, and any other devices on HP-IL. 


The HP-71 Development Utility work station is now connected and ready to run the HP-71 Development 
Utility (refer to Section 3: Operation). 


Testing the Work Station 


The following is a test to make sure that the HP-71 and IBM Personal Computer are communicating: 


1. Initialize the HP-IL/RS-232-C interface by giving the HP-71 the following commands: 
“REMOTE 
“OUTPUT RSSRE; "SEP SF4:3Pa; 
SLUEAl 


en 
ae 
ml 
oh 
gn 
alte 
—_— 
— 
im 


2. Initialize RS-232 for the IBM Personal Computer. Give it the following command (assuming that RS- 
232 is in communication port 1): 


Hel. WA 2 ieee o-oo set ae ae 


3 


EG 
i 


et 


,OS8, C08 


« 
ie 

vote 
j 


3. Prepare the HP-71 to receive data: 
“ENTER FRaetac: AF 


4. Send a message from the IBM: 
Ae ys COR Asad s 
Hello HFP-FYl, how are wou 
CLO TROL Jz 


5. Check to make sure that A$ in the HP-71 has the message that you sent from the IBM: 
*LTSP AF 


Other Hosts and Interfaces 


The HP-71 Development Utility is flexible enough to work with most computers and interfaces. Although 
only the HP-86/87 with HP-IL and HP-IB, and the IBM Personal Computer with RS-232 are covered in 
the manual, here are some suggestions and warnings about setting up a work station using other hosts and 
interfaces: 


e When using RS-232, make sure that baud rate, parity, and word length are compatible with the HP- 
71 and HP-IL (refer to Section 4: Customization). 


e Ensure that the end-of-line and end-of-file sequences are correct (refer to Section 4: 
Customization). 


e If the host is on HP-IL, it must be able to pass control to the HP-71. 


e Send data across the interface manually before running the HP-71 Development Utility. Examples of 
how to do this are in the preceding subsections. 


Section 3 


Operation 


This section explains how to transfer files from a host to the HP-71 (download) and how to transfer files 
from the HP-71 to a host (upload). 


HP-71 


Running the HP-71 Development Utility: XFER 


The bulk of the work for the HP-71 Development Utility work station is done by an HP-71 BASIC pro- 
gram called XFER. XFER is provided on magnetic cards (a cassette tape is available through the 
HP User’s Library). An annotated listing of this program is in Appendix B: Sample Programs. 


XFER can be copied and run from the HP-71 card reader or the HP 82161A Digital Cassette Drive. If 
there is no card reader or cassette drive, the program can be keyed into the HP-71 from the listing (strip- 
ping the comments saves HP-71 memory). 


Example: Suppose you wanted to copy XFER from the magnetic cards and then run the program. To do 
this, you would give the HP-71 the following commands: 

°LUPY 6ePer LAR 

“RUM APFER 
To copy the XFER program from the magnetic cards and run it immediately, give the HP-71 the following 
command: 

7“RUM APER: CARD 
Similarly, to copy XFER from the cassette tape and then run the program, you would give the HP-71 the 
following commands: 

SLORY RRFER: TAFE 

“RUM SPER 
To copy the XFER program from the cassette tape and run it immediately, give the HP-71 the following 
command: 


~RURM SPER: TAPE 
Refer to the HP-71 User’s Manual for more on the COPY and RUN commands. 


The start of the XFER program is signified by: 


He-Pl transfer program 
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XFER searches the loop for an RS-232 interface, an HP-IB interface, or a controller. If only one of these 
devices is found, it is assumed to be the host. If none or more than one of these devices are found, XFER 
prompts for the host: 


Host device? 


In response to this prompt, specify which device is to be the host. You may enter: 
e An HP-IL address (an integer 1 to 30). 
e A device ID (an alpha numeric string such as “HP82169A” or “HP82164A”). 


e An accessory ID (“%n”, where n is the decimal accessory ID). 


An Overview of How XFER Works 


All of XFER’s variables are local. This means that running XFER won’t change any user defined vari- 
ables. Also, XFER’s variables are not available to the user unless XFER is running. 


XFER makes the HP-71 the active controller on HP-IL and takes responsibility for the integrity of HP- 
IL. To make sure that HP-IL is set up, XFER executes the CONTROL ON statement. 


After initializing HP-IL and internal variables, XFER sets up a host and is ready to start uploading and 
downloading files. 


When downloading, XFER reads ASCII data from HP-IL and puts it into a text file specified by the user. 
When uploading, XFER outputs ASCII data to HP-IL from a text file specified by the user. For how to 
specify the text file, see Downloading and Uploading, later in this section. For the specifications of how 
XFER transmits and receives ASCII data, see the subsection on Host Programs at the end of this 
section. 


Guidelines For Using XFER 


At each prompt: 
e You enter a response followed by an [END LINE]. 


e If you have forgotten the meaning of a prompt, respond with a question mark (“?”) for a brief descrip- 
tion of what is expected. 


e XFER displays the default, if there is one. Responding with an re-enters this default value. 
e The smallest, unique representation of a response is sufficient. 

Example: “Y” and “YE” are equivalent to “YES”. 
e XFER converts all responses to uppercase. 


Example: “Yes” and “yes” are equivalent to “YES”. 
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Stopping XFER 


Any time that XFER displays a prompt, the program can be stopped by responding with “END” or “E”. 
This causes XFER to close its files and return control to the HP-71 operating system. 


Any time that XFER is in the process of transferring a file between the HP-71 and the host, the transfer 
can be stopped and any open files closed by typing “S” or “A” on the HP-71 keyboard: 
e The “A” command stops the transfer and ends the XFER program. 


e The “S” command stops the transfer and permits you to halt the host program without tying up the 
interface or HP-IL. When you press “S” during a file upload, XFER sends the end-of-file sequence 
(refer to Section 4: Customization), which halts the program automatically. If you press “S” during 
a file download, XFER continues to read data from the host but does not store the data in a file. If 
you then manually stop the host program, XFER detects the end of transmission after a 3-second 
interval. 


Neither the “S” nor the “A” needs to be followed by an [END LINE]. 


Example: Suppose you begin downloading a file with XFER and then decide that you want to upload 
rather than download. To halt the download, you could type “S” on the HP-71, stop the download on the 
host, and then set XFER to upload and restart the host program. 


Changing XFER for the IBM Personal Computer 


In order to work with the IBM Personal Computer correctly, XFER’s end-of-line variables need to be 
changed. The code to do this is in XFER as a remark line. To change XFER, remove the “!” from line 210: 


S10 | ELS=CHE#C132 & E1S=Eat - 


This changes it to: 
ZLB ELEF=CHREclsas @ ELF=EWF 


This makes lines 190-200 superfluous, so these lines can be deleted, made into remarks, or ignored. ~ 


For more on customizing XFER for specific work stations, refer to Section 4: Customization. 


Software Handshaking 


Software handshaking is a method of automatically controlling the starting and stopping of data transfers 
on both sides of the interface. Interfaces such as the HP 82164A HP-IL/RS-232-C Interface and the 
HP 82169A HP-IL/HP-IB Interface support a variety of handshakings. 


If your host is capable of handshaking on HP-IB or RS-232, the order in which you start running XFER 
and the corresponding program on the host does not matter—each program waits for the other to send 
data at the appropriate time. 
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If your host does not support software handshaking (the sample program for the IBM PC listed in 
Appendix B: Sample Programs does not use handshaking), you have to coordinate the data transfer by 
ensuring that the recieving end is prepared by the time it gets data. 
To download a file: 

1. Respond to XFER’s prompts until the following is displayed on the screen: 

Courloadinma <file mames,,, 

2. Start the download from the host. 
To upload a file: 

1. Prepare the host to recieve a file. 


2. Respond to XFER’s prompts until the following is displayed on the screen: 


HWeleadina ¢tfile mamer..,., 


See the following subsections for more on XFER’s prompts. 


Downloading 


In order for XFER to transfer a file, it needs to know which direction to transfer the file (upload or 
download) and the name of the file to be transferred. First XFER asks for the direction of transfer: 


How load or Upload? O 


or 
Ueload or Download? U 


The “U” or “D” reflects the previous direction of transfer; this is the default for this prompt. In order to 
download, you would respond by entering “D”: 


Couwnload or Upload? Oo 

or 
Upload or Download? Oo 

XFER now asks for the name of the file to be downloaded: 
Dowload file: 


This is the text file that XFER creates to store the data received from HP-IL. If this file already exists 
when XFER tries to create it, you are warned: 


t 


File <f1le name> sglresdy @exi 
Furge old <«<fiLle name>? 


You can then proceed with the purge by typing “Y” or prevent the purge by typing “N”. If the purge is 
prevented, another download file name is requested. 


As soon as XFER has an acceptable download file name, it starts downloading: 


Coun loadina tfile mamer.., 


At this point, you should run the program on the host that downloads the file. 
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If there is a display device on HP-IL, it echoes the data as it is transferred. Otherwise, the HP-71 display 
echoes the data. To maximize transfer speed in the latter case, set DELAY 4, a. 


After the file has been downloaded and XFER is ready to close the file, you are informed by the following 
message: 
Download complete 


If the file has been flagged as a BASIC file (refer to Section 4: Customization), it is trans- 
formed to BASIC after being downloaded: 


Transforming <ifilie mane... 


XFER is then ready to upload or download another file and returns to the “Download or Upload?” prompt 
(see above). 


Example: Suppose you wanted to download a file named “TEST”. To do this, you would respond to 
XFER’s prompts as follows: 


Download aor Upload? Oo 
Cownload file: TEST 


Suppose that you had downloaded “TEST” previously and now had a new version to replace the obsolete 
version. You would then want to purge the old version: 


File TEST already existe, 


Furge old TEST? ‘ 


XFER then purges the old “TEST”, creates a new one, and starts downloading: 
Cownloading TEST... 


You would then download the file “TEST” from the host. As each line is downloaded, it is displayed on 
the display device, or the HP-71 if there is no display device. 


The end of the download is signified by: 


Ciowrlosad complete 


If TEST has been flagged as a BASIC file, it is transformed into BASIC after it is downloaded: 


Transforming TEST... 


XFER then returns to the “Download or Upload?” prompt. 


Uploading 


To upload a file, enter “U” in response to the direction prompt: 


Ciotttiload opr Uplaad’ U | ENDLINE 


or 


Uelead or Downlead? U | ENDLINE 


At this point, you should run the program on the host that uploads a file. 


16 section 3: Operation 


XFER now asks for the file to be uploaded: 
liplosd file: 


This specifies the file from which XFER transfers data via HP-IL. If this file doesn’t exist, XFER dis- 
plays “No such file,” then prompts for another upload file name. 


If the file is a BASIC file, it is transformed into text before being uploaded. To signify this, XFER dis- 
plays the following: 
Transforming “file mame>..., 
After XFER has an acceptable upload file name and has finished transforming, it starts uploading and 
displays the following message: 
Uplesdina «file name:,,, 
If there is a display device on HP-IL, it echoes the data as it is transferred. Otherwise, the HP-71 display 
echoes the data. To maximize transfer speed in the latter case, set DELAY A. &. 
If the upload file was originally a BASIC program, it is transformed back to BASIC following the transfer: 
Tranmestarmirmra «file mame>,., 


XFER is then ready to upload or download another file and returns to the “Upload or Download?” prompt 
(see above). 


Example: Suppose you wanted to upload a file named “TEST”. To do this, you would respond to 
XFER’s prompts as follows: 


Hour load or Upload? U | ENDLINE 
Ueload file?’ TEST |ENDLINE 


If TEST is a BASIC file, it is transformed into text before being uploaded: 


Transformina TEST... 
Pe loead ira bess. 


As each line is uploaded, it is displayed on the display device, or the HP-71 if there is no display device. 


After the transfer, TEST is transformed back into BASIC and the upload is complete: 


Ucload complete 
Traretarmingd TES) s.«:. 


XFER then returns to the “Upload or Download?” prompt. 
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Host Programs 


Program Specifications 


Because of the variety of computers capable of acting as a host for HP-71 Development Utility work 
station, not all work stations can be fully documented. Instead, the specifications for host programs inter- 
acting with XFER are described and explicit examples of such programs are given. You will need to 
provide your host program yourself, either by keying in one of the sample programs from Appendix B: 
Sample Programs, or writing your own program from the specifications. 


XFER is designed to be very flexible in the data transfer process, so that the host programs can be short 
and simple. Section 4: Customization explains how XFER can be customized for your specific work 
station. 


Download Program Specifications 
After XFER displays “Downloading <file name>...,” it has a text file prepared and expects ASCII data 
from HP-IL in the following form: 

<dat><dat> ... <dat> <end-of-line> <dat><dat> ... <dat><end-of-line> ... 


. <dat><dat> ... <dat> {<end-of-line> } <end-of-file> 


where: 
<dat>—ASCII data. 
<end-of-line>—The download end-of-line sequence. 
<end-of-file>—The download end-of-file sequence. 


Refer to Section 4: Customization for how to change the default definition of the end-of-line and end- 
of-file sequences. 


The stream of ASCII data is read into a string variable and transferred into the prepared text file as 
follows: 


e When an end-of-line sequence is found, the data from the string variable is stored in the text file 
followed by a <carriage return> <line feed> (the HP-71 defined end-of-line sequence): 


string variable - <dat><dat> ... <dat> 
An end-of-line sequence causes: 
text file + string variable<carriage return> <line feed> 
After the data is stored, ASCII data is again read into the string variable. 


e When an end-of-file sequence is found, the data from the string variable is stored in the text file 
followed by a <carriage return> <line feed> (the HP-71 defined end-of-line sequence), same as with 
the end-of-line sequence. XFER clears HP-IL by reading any more data that may be on the loop. 
Neither the end-of-file sequence nor any data read after it are put into the text file. 


To download a file to XFER, then, the host program must: 


e Transmit the download file as a data stream broken into individual text lines separated by download 
end-of-line sequences. 


e Signal the end of transmission by sending a download end-of-file sequence. 
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Upload Program Specifications 


After XFER displays “Uploading <file name>...,” it puts ASCII data onto HP-IL in the following form: 
<catalog entry> 
<dat><dat> ... <dat><end-of-line> <dat><dat> ... <dat> <end-of-line> ... 


. <dat> <dat> ... <dat> <end-of-line> <end-of-file > 


where: 


<catalog entry>—The HP-71 file catalog entry. 
<dat>—ASCII data. 
<end-of-line>—The upload end-of-line sequence. 


<end-of-file > —The upload end-of-file sequence. 


Refer to Section 4: Customization for how to change the default definition of the end-of-line and end- 
of-file sequences. 


The first thing that XFER sends is the HP-71 file catalog entry. The host can use this information to set 
up its mass storage to receive the file data. The catalog entry is in the following form: 


Characters Contents — 


1-8 HP-71 file name. 
9-17 Protection and file type. 
18-22 HP-71 file size, in bytes. 


Transmission of the catalog entry is terminated by the upload end-of-line sequence. 


Following the catalog entry, XFER transmits the contents of the file as a continuous stream of ASCII 
data. XFER reads the file from memory, record by record, and sends each record followed by the upload 
end-of-line sequence. 


After the last text line is sent, XFER transmits the upload end-of-file sequence. 


To upload a file to XFER, then, the host program must: 
e Initialize a file, either on a mass memory or in internal memory, to receive the tranferred data. 


e Read the catalog entry, and either use the information in the entry, or discard it. The catalog entry 
should not be stored in the file. 


e Copy the incoming data into a file, in a format that can be utilized by a text editor on the host. 


e Recognize the end-of-file sequence, and terminate the data transfer in a manner that leaves HP-IL 
ready for futher operations. 


Section 3: Operation 


Some general considerations you may wish to take into account in the host program are: 
e Where is the data coming from? 
e What file will the data be stored in? 
e Where will the file be stored (mass storage device)? 
e What type will the file be (BASIC, text, data)? 
e What will happen if the file already exists? 
e How will the data transmission end (end-of-line and end-of-file sequences)? 


e How will an error in transmission be handled? 


Refer to Appendix B: Sample Programs for examples of uploading programs. 


19 


ae, 





Section 4 


Customization 


The HP-71 Development Utility program is designed to handle a variety of hosts and work station 
configurations. Although the defaults are appropriate for most “common” configurations, they can be 
customized to other configurations. 


How To Customize 


Customization is achieved through altering the XFER program code. There are 11 variables that are used 
for customizing. These variables are on lines 140-210 and 1640-1670 of the XFER program: 


i486 S=128 
L5H C=i 

lee B=] 

178 2H$="E0F" 

130 Fit="EOF" 

190 EAS=CHREC1S9RCHREC LBS 
SAA ELF=CHREC LER CHREEC ios 
214 | EPRF=CHRECLS:2 & ELE=EG# 
i6é4a@ BS="SEF" 

1656 PE="P4" 

1666 PS$="SPa" 

L678 We="She" 


To change a variable in the XFER program, you need to: 
e EDIT the program XFER. 
e FETCH the line containing the variable. 


e Change the value of the variable. 
Refer to the HP-71 Owner’s Manual for more on editing BASIC files on the HP-71. 


Example: Suppose you wanted to change the value of variable B on line 160 from 1 to 0. To do this, you 
would give the HP-71 the following commands: 


“EDIT s#FER 
ore Lb, ee 


In response to these commands, the HP-71 displays line 160 of XFER: 


L 


‘lle 


Ei = 1 


Ty 


I 


This line can then be changed to read: 


164 B=a 


sech 
+ 


After hitting the key, this change becomes permanent in the HP-71 memory. 
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Customizing XFER’s Variables 


Two string variables, X$ and A$, are used for temporary storage of data transferred to and from the HP- 
71. The string lengths are determined by the variable X (line 140). To minimize the memory used by 
XFER, you should dimension these strings as short as possible, by choosing a value for X according to the 
following guidelines: 


e X$ has length X; A$ has length 2X. 


e A$ must be as long as the longest line in the file being tranferred. 


Customizing HP-71 Files 


There are two variables that determine how XFER treats HP-71 files. 


e C (line 150): Before downloading a file into a file name, any file which already exists by that file name 
is purged. The variable C determines whether or not the user is warned of this purging before it 
happens. 


For example: Suppose you were downloading a file “TEST”. 
If C=1 (the default), XFER warns you of the impending purge by displaying: 
File TEST] already existe, 
Furge old TEST’ 
You could then accept the purge by typing “Y” or stop the purge by typing “N”. 
If C=0, XFER automatically purges “TEST”. 


e B (line 160): Files are transferred by XFER as text files. The variable B is used for aiding in the 
development of BASIC programs. If B=1, XFER assumes that a file being downloaded is a BASIC 
file and transforms it after it is received. 


For example: Suppose you were downloading a file “TEST”. 
If B=1 (the default), XFER transforms “TEST” into BASIC after it is downloaded. 
If B=0, “TEST” would be stored in the HP-71 as a text file after it is downloaded. 


Customizing End-of-Line and End-of-File Sequences 


As a file is downloaded, XFER stores it as lines in a sequential text file. 


The end of an individual line is determined by E0$ (line 190). The end of the file is determined by Z0$ 
(line 170). EO$ and ZO0$ are from 1 to 18 characters. 


During a file upload, XFER appends E1$ (line 200 or 210) to each line of the file and transmits Z1$ (line 
180) to indicate the end of file. E0$ and Z0$ are from 1 to 18 characters. 


Note: Make sure that the end-of-line and end-of-file sequences are unique and occur in the file only 
at the appropriate place(s). Non-uniqueness can lead to files being transferred incorrectly. 
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Customizing HP-IL 


The subprogram “WH(H)”, lines 1510-1620, is provided to prompt you to specify a host when either: 
e No HP-IL controller, HP 82169A, or HP 82164A is connected on HP-IL. 


e More than one of the above devices are present. 


If you expect to have one and only one host on HP-IL you may delete lines 1520-1620 to save HP-71 
memory. 


Customizing, the HP 82164A HP-IL/RS-232-C Interface 


The subprogram RS(H), lines 1630-1960, is provided to initialize the HP 82164A Interface. If you are not 
using this interface, you may delete lines 1630-1690 to save HP-71 memory. 


RS-232-C is a very flexible interface with a wide variety of possible options. The HP 82164A can be 
initialized to incorporate these options. Four of these options are automatically initialized by the sub- 
program “RS(H)”. You can modify the values used by XFER or add RS-282-C configuration specifiers by 
editing the “RS(H)” subprogram. Refer to the HP 82164A HP-IL/RS-232-C Interface Owner’s Manual for 
what options are available and how to initialize them. 


The RS-232 options automatically initialized by XFER are baud rate, parity bit, parity error shown, and 
word length. They are initialized to work with the IBM Personal Computer according to the configuration 
set up by the program in Appendix B: Sample Programs. 


e Baud rate (B$, line 1640): baud rate determines how quickly data is passed along RS-232. The default 
is 600 baud. This rate is chosen as the maximum data rate that XFER can process with no software 
handshaking. 


e Parity bit (P$, line 1650): For error checking, there is usually a bit which is used for parity. The 
default parity is no parity. 


e Parity shown (P5$, line 1660): The parity bit is usually shown as the high order bit of the data byte. 
The default is for the parity bit to not be shown on the data byte. 


e Word length (W$, line 1670): If a parity bit is taking up part of the data byte, then the word length 
can be less than 8 bits. The default is an 8-bit word. 


Appendix A 


Quick Reference 


Configuration 


To set up an HP-71 Development Utility work station you need to: 
1. Power down. 
2. Initialize the interface converter if one is being used. 
3. Connect cables. 
4 


. Power up. 


Operation 


To Accomplish: Respond With: 


Entering download mode. | Download or Upload? o 
Upload or Download? Oo 


Entering upload mode. Cownloaad or Upload? uu 
Upload or Download’? U 


Downloading a file. Uowrload file: ¢file mame>[ENDLINE 
Uploading a file. Ueloasad file: “file mame>{ENDLINE 
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Customization 


X,140 Variable lengths. X=120. Positive integers. 


C,150 User warned before | C=1 (Warned). C=0 (Not warned), 
files purged? C=1 (Warned). 


B,160 BASIC or text files. | B=1 (BASIC). B=0 (text), 
B=1 (BASIC). 


Z0$,170 End of download | ZO0$=“EOF’”. < 18 characters. 
file. 


Z1$,180 End of upload file. Z1$=“EOF”. < 18 characters. 


E0$,190 End of download | E0$=CHR(13)&CHR$(10). | < 18 characters. 
line. 


E1$,200 End up upload line. | E1i$=CHR$(13)&CHR$ < 18 characters. 
(10). 


B$,1640 Baud rate. B$=“SB8” (1200). B$=“SB1” (50), 
B$=“SB2” (75), 
B$=“SB3” (110), 
B$="SB4” (135), 
B$=“SB5” (150), 
B$=“SB6” (300), 
B$="SB7” (600), 
B$=“SB8” (1200), 
B$=“SB9” (1800), 
B$=“SBA” (2400), 
B$="SBB’ (3600), 
B$="SBC” (4800), 
B$="SBD” (7200), 
B$=“SBE” (9600), 
B$=“SBF” (19200). 


Parity bit used. P$=“P4” (None). P$=“PO” (Even), 
P$=“P1" (Odd), 
P$=“P2” (0), 
P$=“P3” (1), 
P$=“P4” (None). 


P5$,1660 Parity bit shown. P5$=“SPO0” (Disabled). P5$=“SP0” 
(Disabled), 
P5$="SP1”" 
(Enabled). 


W$,1670 Data bits per word. | W$=“SWO” (8). w$=“SWO” (8), 
w$=“Sw1” (7). 
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12@ 
13@ 
142 
15@ 
162 
17 
18@ 
19@ 
200 
212 
220 
230 
2AD 
290 
260 
27Q 
280 
298 
300 
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33@ 
#342 
358 
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372 
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400 
419 
42@ 
430 
440 
4950 
46@ 
4°7@ 
480 
490 
088 
018 
920 
938 
040 
008 
068 


Appendix B 


Sample Programs 


HP-71 Development Utility Program XFER 


TAPER” Peoaram for HP=71 

CALL. XFERX |! Makes program variables local 
ENO 

SUB XFERX 

X=1290 | Set I/O array sizes 

C=1 | Purge warning 

B=1 | Automatic transform to/from BASIC 
Z0$="EOF" |) cot Download end-of-file 
Z1$="EQOF" | Upload end-of-file 
EQ@$=CHRS(LSIBCHRS(1Q) | Download end-of-line 
E1$S=CHR$( 13 )8CHRS( 10) | SY Upload end-of-line 


{ EQ@S=CHRS(13) 6 ELS=EQE For bh: PG | 
Initialization: 

DIM FSL81,F1$f151],A8f2*X1, XSI XY 

SFLAG -1 @ SFLAG -23 4 Quiet mode; stop on ETO 
CONTROL ON Assert system control on HP-IL 
D=DEVADDR( "DISPLAY" ) @ P=DEVADDR( "PRINTER" ) ! Find display and printer 
TF 0°20 THEN DISPLAY IS :-0 ELSE DELAY @.0@ ! Choose a display 

DISP “HP71 transfer program" | 

DS="Download" @ O$="Upload" 

Fos" " 

| Find potential hosts: 

"HOST'’: L=DEVADDR("Z1") @ R=DEVADDR("%66") © G=DEVADDR( "467" ) 


H=(Re@)+(G2Od+(L2O) |! Count hosts; if not 1 then query user 
TF Het OR H=-2 THEN CALL WHCH) ELSE H=MAX(L.MAX(G6G.R)?) 
"DIR’: DISP DSB" or “BOSB"? "5; | Input direction 


INPUT “" DISC 1,13;D1L% © DIS=UPRC$(D1$) 

IF POSC "END" ,018)=1 THEN ‘CEND Y ; 

IF Bigs="?" THEN CALL HELP(1,DS) @ GOTO 'DIR™ 

IF DASl 1.1}. °0$€1,11] THEN T$=DS 6 DS=O8 R OS=TE 

| Get file name 

"RDFN’: DISP DSB" file: °; @ INPUT "“.FS;FiS @ FIS=UPRCS(F 1S} 
IF Filg="" THEN BEEF @ GOTO ’RDFN’ 

TF POSC"END” FS d=1 THEN *CEND® 

IF Flg="?" THEN CALL HELP(2,08) @ GOTO °RDFN’ 

ON ERROR GOTO 462 © RENAME FI1E TO FiS ! Chect if file exists 
OFF ERROR @ IF ERRN=58 THEN DISP ERRMS @ GOTO 'RDFN’ |! Invalid file name 
FS=F1$ 

IF ERRN«°57 AND ERRN© 259 THEN DISP ERRMS @ GOTO ‘CEND’ ! Unexpected error 
IP DSi tsa THEN: UR Pe? 

ITF ERRN=57 THEN ’CR’ | File does not exist 

TF NOT -C. THEN *PFN? 1 Purge without warnina 
DISP F$;" already exists." @ WAIT .5 

DISP “Purge old "BFS; @ INPUT KS @ KS=UPRCS(KS) 

IF POS( "END" .K$)=1 THEN ’CEND’ 

IF K$="?" THEN CALL HELP(3,0$) @ GOTO 53@ 

TE. POSC"VYES” KS 74-1 THEN: *ROFN® + Get a new file name 


Kf your system configuration consists of only the HP-71B, RS232 Interface and the IBM PC, you 
will need to change line 340 to ready 340 CALL WH(H). As it is, the conditional tests are not met. 
Therefore, the subprogram is never called. 
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978 
08 
998 
600 
61@ 
620 
632 
640 
650 
660 
678 
68@ 
698 
730 
710 
ic 
738 
746 
790 
76R) 
77G 
7388 
790 
Baa 
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be 
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3840 
Bot 
Boe 
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B8O 
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91@ 
320 
93@ 
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afQ 
9350 
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1912 
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[O4@ 
1Qde@ 
18608 
1872 
1920 
1Q3¢ 
1190 
1118 
Lica 
1136 
114@ 
11508 
1169 
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"PFN’ =: PURGE FS 

"CRA? CRER TE: LEME FS 

"DF? : DISP DSb’ ind *sFSIC sae” 4 Download 

ASSIGN #1 TO FS @ AG="" 

STANDBY .5 @ Di=@ ! . Di=@ means no data yet 
*RDS’: KIS=UPRCSCKEYS) | Check keyboard 


TF Kig="S" THEN ASSIGN #1 70 * @ GOSUB ‘°CLN’ @ GOTO ’°DIR’ 
IF K1$="A" THEN ’°CEND’ 

SEND MLA TALK H } Make host talker 

IF O2@ THEN SEND LISTEN D |! Make display listener 


ON ERROR GOTO *NODAT’ @ ENTER :-LOOP ;xX$ @ SEND UNT UNL ! Read from host 
QOQFF ERROR @ IF X$="" THEN "RDS > If no data then try again 
IF D<@ THEN DISP KS; | Lf no HP-IL. display, show on HP-71 


IF NOT D1 THEN Di=1 ® STANDBY 2@ | Data transmission has started 
ON ERROR GOTO ‘'LTL* © AS=ASE&BXS G OFF ERROR ! Add new data to current line 
"ROL? :. Pl=POS(AS,7@$) @ Pe=FPOS(AS,E@S) |! Look for EOF and EOL 

IF Pl?>@ AND P2eeP1l THEN Pe=a | Discount EQL if after EOF 

TF MEM<2@@ THEN “TOBIG’ ! Bail out if not enough memory 

Ce Pe TREN: "Pet 

TF NOT Pl THEN ‘ROS’ | Neither EOL nor EOF; read more 
IF Pt2i THEN PRINT #1;AST1.P1-1] ! Trim off anything past EOF 

GOSUB *CLN’ @ GOTO ’FILEND’ | Clear the host output 

"Pe?’: TF Pesi THEN PRINT #1;3A8f1.P2-1] ! Add data to file, up to EOL 
FS=PeCt+LENC EUS > | P3 indicates start of next line 
IF PS“=LENCAS) THEN AS=ASIPSG] ELSE AG="" | Keep next line in AS 

GOTO *RDL* 3 Look for another EOL 

PaE NOs) = a Download complete 


BISP “File ";F$;" downloaded." 

ASSIGN #1 TO * 

IF NOT B THEN ’DIR’ | No transform 
CRAG. =k 2 Clear quiet mode 


OFF ERROR 


50SUB ’T’ 
TF P2@ THEN DISPLAY IS :P ! Make printer list transform errors 
ON ERROR GOSUB "TE | Trap transform fail error 


TRANSFORM FS INTO BASIC 


OFF ERROR @© IF P>@ THEN DISPLAY IS * 

Ee iDee: THEN BISPLAY ..5.-30 

DLSP: ““Teans form. "4 Check file type to see if transform complete 
TF PEEKS(DTHS(HTD(ADDRS(F$)9416).4)<>"10@80" THEN DISP “complete.” ELSE DISP 
SFERG. =1. 3 Restore quiet mode 


GOTO "OIR’ 
"TE*: TF ERRN«>75 THEN DISP ERRMS | Transform errors 
bO07O 330 
| Upload code. If file does not exist, get a new file name 
"UPF’: TIF ERRN=S7 THEN DISP FSB" does not exist.“ @ GOTO ?ROFN? 
{ TPF the file is mot BASIC, don’t try to transform 
TF PEEKS( DTH#CHTDCADDRS(FEI)t16),4)="10020" THEN Bi=@ © GOTO 1068 


GOSUB ‘T* @ TRANSFORM FS INTO TEXT © Bl=1 

DISP DSR "ing "sFSE ew.” 

ASSIGN #1 TO FS 

ENDLINE ELS 

AS=F HS” " @ X$=XSlL,a) | Find catalog entry number: 


FOR T=1 TO 1000 @ TF K$=CATS(TIL1,81 THEN lied 

NEXT 

DISPLAY IS * @ GUTPUT :H ;>CATS(T)} |! Send the catalog entry to host 
KIiS=UPRCHC KEYS?) | Check keyboard 

TF K1$="A" THEN *CEND’ 

SEND MTA LISTEN H @ IF O°@ THEN SEND LISTEN 06 ! Listen host and display 
TF Kigs="S" THEN 121@ 
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L18@ 
119@ 
1208 
121@ 
t2c@ 
123@ 
1240 
1259 
i26a 
127@ 
1280 
1290 
1308 
L218 
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136@ 
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DUG 
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156@ 
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ON ERRGR GOTO 121@ @ READ #1;A%S @ OFF ERROR ! Read a line: trap file end 
OUTPUT :-LOOP ;AS © IF D<@ THEN DISP AS |! Send the line to host 

SEND UNT UNL 

GOTO 1138 | Read next line 

OUTPUT -LOGP ;Z1$ @ ASSIGN #1 TO *# | Send End-of-file 

SEND UNT UNI @ IF O2@ THEN DISPLAY I5 :D 1 Restore display 

OFF ERROR 

IF Bl THEN GOSUB °T’ ® TRANSFORM FS INTO BAS 
GOTO *DER” 

PY *2. DESP “Aranstormind “srSs sa” @ RETURN | Transform diseley 


=. 


Lv 


*NODAT*®: SEND UNT UNL @ TF NOT O1 THEN “RDS” |! No data 
BEEP @ DISP “HP-IL Timeout" @ WALT .9 © GOTO *CEND’ 
Met 2) OEP. (ERROR: 4 Line too long 


DOISP "Line teo long." @ DISP DSR" aborted.” @ GOSUB ’°CLN’ © GOTO ’°DIR’ 
"TOBIG’: BEEP ®@ DISP “Insufficient memory." @ GOSUB 'CLN’ © GOTO °CEND’ 
"CLN?: ITF De@ THEN DISPLAY IS :D ' Read any remaining output from host 
DISP “Watt...” -@ STANDBY 3 


ON ERROR GOTO 1360 

ENTER tH -:XS @ WALT «1 @ LF XS" THEN 235@ |! ENTER toap 
RETURN 

“CEND*: ASSIGN Fil TOs. 4 Normal orogram end 
STANDBY OFF @ CFLAG -1 @ ENABLE INTR @ 


ENOLINE “@BELAY -.3)% L253 

DISP “End of program." © END SUB 

SUG HEL PCH eo 4 Help messade® suboproaram 
T$="Enter: “ 

ON X GOSUB 1470.1480,1496,1500 

Oise XS -@ WALT 5 

LP Gee “THEN DLS VS 3 WATE. 2 

607). 151i 

X$="Direction of transfer." © Y#=IS8"U or O" @ RETURN 

X$=[ER “filename of” © ¥H="file to “&OF 6 RETURN 

X$=ISR"Y or N"“ © YE="" O@ RETURN 

X$=TSER"host dev. spec:” © ¥$="DevID, *AccID, or addr” © RETURN 

END SUB 

SUB WHCH) |! Select a host: 

INPUT "Host Device? ";H# @ HB=UPRCS(CHS) 

TF POSC "END" ,H$3=1 THEN *CEND’ 

TF HS="7" THEN CALL HELP(4.08) @ GOTO 1530 

ON ERROR GOTG ‘NH’ | 

H1=DEVAIDCHS) | Determine selected device type 
H=BINAND(H1L,246) @ ITF He>@ AND Hi264 THEN °NH’ |! Controller or interface? 
H=DEVADDR(CH®) @ ITF Hl=66 THEN CALL RSCH) | Tf RS-e3e then initialize 
END 

"NH’: DISP ’Invalid host.’ @ WATT .5 © GOTO 1539 

END SUB 


SUB RS(H) | RS-e@3e initialization 

BS="SB7" | 62 Baud 22 3m SBA = 240° 
P$="P4" | No parity 

POS="SPO" | Disable parity error 

WE="SWA" | 8 bit words 

REMOTE @ OUTPUT :H ; B88"; "BPSBR": "BPSSR": "BBWS | Send remote mode commands 


LOCAL @ END SUB 
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Sample Program for the HP Series 80 


The sample transfer program for the HP series 80 looks very similar to the XFER program on the HP-71 
when it is operating. The following is explicit instructions on how to use this program. 


Running the HP Series 80 XFER Program 


If the HP-86/87 is connected to HP-IL by the HP 82938A HP-IL Interface, the Series 80 XFER program 
can be used as it is listed below. If you are connecting the HP-86/87 to HP-IL via the HP 82169A 
HP-IL/HP-IB interface, you will need to alter line 30 of the program to read: 


30 I= <device selector > 


Where <device selector> is the device selector of the HP-IL/HP-IB Interface. Refer to the HP-86/87 
Owner’s Manual and Programming Guide for more on device selectors. 


In the HP-71 XFER program, the end-of-line sequences E&# and E1i# should both be set to 
CHRE¢ L232 CHE#¢18% (carriage return, line feed). The end-of-file sequences 2&4 and 21+ should 
both be “EOF”. Refer to Section 4: Customization for more on XFER’s end-of-line and end-of-file 
sequences. 


To set up communications between Series 80 and the HP-71, you would do the following: 


1. RUN “XFER” on the HP-71, specifying the appropriate host (“%1” for the HP 82938A, “%67” for the 
HP-IL/HP-IB interface). 


2. RUN “XFER” on the HP-86/87. 


When the HP-86/87 XFER is run, it asks for a direction of transfer: 
WIPLOARD OF DOWMAHLORDS 


To upload, you would respond with a “U”, a “D” downloads. 


Uploading 


After the HP-86/87 has entered upload mode, it prompts for the upload file name: 
UPLOAD FILE HAMNE: # 


At this point, you may enter: 


e A file name followed by an [End line]. 
e An(End line]. This causes the mass storage file anme to be the same as the filename used by the HP- 
7A 


The HP-86/87 now waits until it receives the file catalog entry from the HP-71. It then creates a data file 
on the current mass storage device to receive the uploaded file. If a file already exists with the designated 
file name, the following prompt is given: 


file mame> ALFEADY EXISTS, PURGE OLD ¢file names? 


If you respond with “Y” , the old file is purged. Otherwise you are asked for a new file name. 
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After the file is created, the display shows: 


WPLOAOTHG ¢<file name>... 


Then the file characters are echoed as they are received. When the end-of-file sequence is received, the 
HP-86/87 displays: 


UPLOAD COMPLETE, 


The program then returns to the UPLOAD OR DOWNLOAD? prompt to set up for another file transfer. 


Downloading 


After the HP-86/87 has entered download mode, it prompts for the download file name: 
DOWMLOAD FILE WANE: * 


At this prompt, enter the file name of the file to be transferred from the HP-86/87 to the HP-71, followed 
by [End line]. If the designated file does not exist, the following message is displayed: 


Stile name> OOES HOT EXIST 
A new download file name is then prompted for. 


At the start of the download, the HP-86/87 displays: 


DOWMLOADQIMG <file mame>,,, 


The transmitted characters are displayed as they are sent to the HP-71. When the transfer is complete, 
the display shows: 


DOMMLOAD COMPLETE 


The program then returns to the UPLOAD OR DOWNLOAD? prompt to set up for another file transfer. 


Program Listing 


a>. "XFER" orogream for HF Series 8o 
eo Z£1S= "FOR" og FOp=e Tis | eet end-of-file 
il [og |! specify active interface 


40 DIM X#096] 

SO DISF "UPLOAD OF DOWNLOAD";2 INPUT x4 
40 X$=UPCe (XH) 

70 IF X$="" OR X$="E" THEN END 


go [F X#="DB" THEN 370 ! Download? 

Oe UPLOAD: 

1O0 GOSUB S7oa |! Get file name 

110 ENTER I 3 X$ ! Get catalog entry from HE-71 
120 FeVAL (X$€18,2231) ! HF-71 file size 

130 IF FS <> "" THEN 160 ! Use user-supplied file name? 
140 F@=X$f1,8] ¢ | Catalog entry file name 


150 F=POS (F$." ") 2 IF Pi> O THEN F$=F$01,FP—-11 ' Truncate SDAaACes 

L6oO ON ERROR GOTO 446 ! Trap file already exists errer 
170 CREATE. FS. rsFe1.4 | Create destination file 

180 OFF ERROR 

17O ASSIGNH 1 TO FS 

2OO DISF "UFLOADING "sar"... 


eiO ENTER Ios xX€ ! Read one line from interface 
22) DISF X$ ! 2isplay each line 

—~——~ 20 FPRINT#H 1 os XS ! Store im file 
e440 IF £$ <2 Z1l4 THEN 21a ! If line is not EOF, read more 


200 ASSTGON# + TO x Close file 
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24a DISE "UFLOAD COMPLETE" @ GOTO 
TFT 

wet (GOSWUE cer) 

eo ON ERROR GOTO 29 

SO ROoSTGONH 1 TO FS 

ot) Sr  “pOwWNLOABING. “greet ea. 
Soe OR ERROR GOTO |i! Trap end of file error 


ao 


DOWLOAD s 


foal! RE ABH | « XX ! Fead a line from the tile 


24 TDTbe xs | Display the line 

S4Ae OFF ERROR 

aoe OUTPUT oh Ae Output to interface 
mer Te ae ee. 2: TAN Sues ff mot EOF, read mare 
S70 DSF "DOWNLOAD COMPLETE.” 
mt GOTO So 

pees. | 

400 IF ERRN «<> 6&7 THEN GOTO Saco 
410 OFF ERROR 

a2 DIESE Pte" DOES NOT EATS). 
G30 GOT Bao 

Bae 

4S OFF ERROR 

460 IF ERRN <> G3 THEN Gao 

470) BEEF 

(409 DIS Fea" ALREADY EXISTS. PURGE OLD “srSs 
490 THRO Aad 

SOO IF ASCi,1ld="¥" THEN FURGE FS a 


wae GOS 70 


Nomex paetent file error 


Juglicate file error 


a 


BOO eo 


sr es Oe ae Oa Ae oo 
ene Qther errors 


Fad DISE "ERROR #" : RRA 
So DiS “FROGRAPM HALTED. " 
Si EMD 

evo TF xb" THEN BDISF "URLOAD "sSELSE PDISF "DOWNLOAD 
Som DESe "FTLE NAPE: "s 

Soo TNRPUT Fea Feros cr Bs 

Got TP Pe "EM THEM END 

SiO RE TUR 

Pe eEN os End of data error 
G20 IF ERRA <> VE THEN Sao 


S40 X$= 708 wv GOT 2b 


a 
_ 


Sample Program for the IBM Personal Computer 


The sample transfer program for the IBM Personal Computer looks very similar to the XFER program on 
the HP-71 when it is operating. The following is explicit instructions on how to use this program. 


Running the IBM PC XFER Program 


The end-of-line sequences E0$ and E1$ in XFER on the HP-71 should both be set to CHR$(13). The end- 


of-file sequences should be “EOF”. 


The IBM PC XFER is a BASICA program and should be run like other BASICA programs. When it is 


run, it gives the following prompt: 


UPLOAD OF DOWMLOAD 


To upload, you would respond with a “U”, a “D” downloads. 
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Uploading 


After the IBM PC has entered upload mode, it prompts for the upload file name: 

PP LOA FILE 7 
At this point, you must enter a file name followed by an (End line]. The PC then creates a data file on disk, 
purging any existing file by that name. Then the following message is displayed: 

WPLOAOTHG «file names... 
Now run XFER on the HP-71, specifying host “%66” and upload. The IBM shows the lines of text as they 
are read from RS-232. When the end-of-file sequence is received, the PC displays: 

UPLOAD COMPLETE. 


The program then returns to the UPLOAD OR DOWNLOAD? prompt to set up for another file transfer. 


Downloading 


Run XFER on the HP-71, specifying host “%66”, and download. Continue with program execution until 
the “Downloading <filename>...” appears on the HP-71. 
After the IBM PC has entered download mode, it prompts for the download file name: 

DOWLOAD FILE % 


At this prompt, enter the file name of the file to be transferred from the IBM PC to the HP-71, followed 
by (End line]. If the designated file does not exist, the following message is displayed: 


“file mames DOES HOT EXIST 

A new download file name is then prompted for. 

At the start of the download, the IBM PC displays: 
DOWAHLORODIKNG ¢<file name>... 


The transmitted characters are displayed as they are sent to the HP-71. When the transfer is complete, 
the display shows: 


DOM AHLOARO COMPLETE 


The program then returns to the UPLOAD OR DOWNLOAD? prompt to set up for another file transfer. 


Program Listing 


(Zoe 
i REM ! "YEER" PROGRAM FOR TBM FC 
a OREN "COM1:600,N,6,1,R5, C959, 050, Cda" Ad #i:s REM Open RS-2S2 channel 
10 PRINT "UPLOAD OR DOWNLOAD "; 


20 INFUT De ~*~ PREM Input direction of transfer 
OO TF De="" OR D$="E" THEN Foo 

4io Xmen Rae 

5 Ege "EOF" col PREM End-of-file sequence 

fO TP DS="U" OR D$="u" THEN PRINT "UPLOAD "; ELSE PRINT "DOWNLOAD "; 

BO INPUT "FILE "sF¢ PREM Input file mame 

9O TF FS="E" OR F#="" THEN Foo 


100 TF Déee"U" AND Déo2"u" THEN GOTO 260 
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PL) 
Ary 
41% 
420 
425 
Ao) 
Ae) 
Hat 
me) 
wa) 
St 
At) 
Ola 
ta) 


stot 
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Pe 

OM ERR GOT 4h) t REM 
BILL Fb : 
ON ERROR GOTO © 
DFEN Fe FOR OQUTFUT 
PE TNT “UURLOADING 
LIWE JNMPUOUTSL, A® 
LIne INPUT #1, xs 
IF Xe" " THEN GOTO 
PRGA) Hil, x 

Fis tney 4% 

TF Xe SES THEN 
PRINT "URL Get 
GOT 4c 
bike 

ON ERROR 
DREN Fe FOR TNFUT AS 
GM ERROR GOTO 
PRINT "DOWNLOAD TMG 
OM ERROR GOTO 600 
LiNE INFUT #2, x3 
TO LEN (xX) 


AS Fi 

ee? oe ae 
2 REM 
s REM 
s REM 
e REM 
e REM 
2 REM 


i7a 


GOTO 170 


GOTO 420 SAPVee 


+ sREM 


ei at he ues i 


REM 


IF X2127 THEN MIDS (X4, 1,1) =CHR®(X-128) 
NEXT I 

IF X32 THEN 
PRINT #1, %% 
FRINT x4 

LF X$<xHE% THEN 
PRINT "DOWNLOAD 
CLOSE #2 
GOTO 19 

IF ERRS 253 
PRINT Fay" 
RESUME 7¢ 
IF ERR < 353 
RESUME NEXT 
CLOSE #1 
CIN ERROR 
EMD 

IF ERRG > 62 
X$=E$ 
RESUME 
CLOSE 


Xba RIGHTS OX$,LEN(XB)—1) ¢ 
> REM 
> REM 

320 2 REM 

COMPLETE" 

2 REM 


THEN 
DOES 


WOO 


NOT 


PREM 
EXIST." 
THEN 


OD 


GOTO © 

THER Sao 2 REM 
fREM 
csegl} 


HIS END 


GOTO 


Close 


REM 


UF LOAD: 

Non-existent file trap 
Kill old vergsicn of file 
Qpen file for printing 
Throw away catalog entry 
Read &@ line from ROS-2 32 
l¢ mo data, try again 
Print the line ta the 
Display the 


Line 
If mot EOF, read 


#ile 
mor & 
DOWNLOAD: 


Nonm-@xptstent 
Cipnen the file 


file trap 


Bead «a line from the file 


B46 2: REM Strip control chars 
Frint line to RS-232 

Display line 
if rot EDF. 


read more 


file 


Non-existent download ¢11e error 


Non-existent upload rile error 


End of data error 
Send end of file 


Appendix C 


Glossary 


Baud rate—The rate at which data is transferred across RS-232. 

Download—tThe process of transferring a file from the host to the HP-71. 
Handshaking—See Software Handshaking. 

Host—The computer which generates HP-71 files and transfers them to and from the HP-71. 


HP-71 Development Utility—A program which runs on the HP-71 and allows the user to transfer files 
between a host and the HP-71. 


HP-71 Development Utility work station—tThe set of equipment and software that allow the user to 
transfer files between a host and the HP-71. 


Parity—dAn error checking method used by RS-232. 


Software Handshaking—The method of automatically controlling the starting and stopping of data 
transfers on both sides of an interface. 


Upload—tThe process of transferring a file from the HP-71 to the host. 


XFER—tThe file name of the HP-71 Development Utility. 
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Troubleshooting and Errors 


The following table provides suggestions for solving problems with the HP-71 Development Utility work 
station. This list is by no means complete. Frequently, there are several possible causes of a particular 
malfunction. 


Nothing happens when XFER is run. | HP-IL is hung. e Reset HP-IL: 
PRESET HIE 
RESTORE [0 


HEIL timegut, A break in HP-IL. e Make sure that HP-IL cables 
form a complete, unbroken 
loop. 

e Make sure that all HP-IL de- 
vices on the loop are turned 
on and operating properly. 


Host Device'’y No host or multiple potential | e Respond with the HP-IL ad- 
hosts on HP-IL. dress, device id, or acc. id of 


the host. 


Invalid Host, The device specified at the Check the HP-IL cables to 
“Host Device?” prompt is not an and from a valid host. 
interface converter or a Re-enter the HP-IL address, 
controller. device id, or acc. id of the 

host. 


Invalid file mame: Unacceptable HP-71 file name. Re-enter an acceptable file 
fille rmames name. 


rane? already A file already exists with the | e Purge the old file. 


$1 
Sy specified download filename. Rename the new file. 


1 
MLEts 
Fur 


e Old <file mame? ? 

Lfile mame-> The HP-71 can’t find a file with Re-enter the file name. 
does rot exist, the name <file name>. 

Files not being transferred. Work station not correctly set Re-set up the work station. 

up. 


Stray symbols in the transferred file. | Incorrect initialization of the Re-initialize the HP 82164A. 
HP 82164A. 


Transferring process ending before | Non-unique end-of-file Redefine the end-of-file 
the file is completely transferred. sequence. sequence. : 
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Transferring process ending before | Non-unique end-of-file | e Redefine the end-of-file 
the file is compietely transferred. sequence. sequence. 


Transferring process not ending after | No end-of-file sequence found. | e Put the end-of-file sequence 
the file has been transferred. at the end of the file. 


Tmeuf ficient memory, Memory of the HP-71 has been | e Purge unnecessary files in 
exceeded. the HP-71. 


Downloaded BASIC file has not been | Transformation failed. e Check download file for fatal 
transformed into BASIC and is still a errors. 
text file. 
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